home *** CD-ROM | disk | FTP | other *** search
/ Precision Software Appli…tions Silver Collection 3 / Precision Software Applications Silver Collection Volume Three (PSM) (1993).iso / music2 / yam77v11.arj / README < prev    next >
Text File  |  1992-12-04  |  10KB  |  221 lines
  1.  
  2.  
  3.                              yam77 (Version 1.1)
  4.  
  5.  
  6.  
  7.      The  program is written in Turbo C and has been tested on an  Elonex
  8.      486  running  DOS 5.0.  I use a TG77 so this has not been tested  on
  9.      the SY77 but as far as I know the midi implementation is pretty much
  10.      the  same except for the individual output selects on the TG77 so  I
  11.      would expect the program to work.
  12.  
  13.      The program requires an MPU compatible midi interface card.  I use a
  14.      Voyetra  V22m  and  the  MPU is used in dumb  (UART)  mode  by  this
  15.      program.
  16.  
  17.      Acknowledgements  to  Jim  Conger for the ideas I used from  his  "c
  18.      Programming for MIDI", and Sam Herrington for hacking assistance.
  19.  
  20.  
  21.  
  22.  
  23.  
  24.      YAM77.EXE
  25.  
  26.      Firstly,  the program is not yet complete but I could use some  user
  27.      type  feedback before continuing.  Because of the sometimes  obscure
  28.      ways  that Yamaha store their data there are probably a few features
  29.      in the program which need fixing.
  30.  
  31.  
  32.  
  33.      The program is designed to allow the automatic downloading of single
  34.      voices,  banks of 16 voices, or memories (i.e.  64 voices) from your
  35.      TG77  or  SY77.  You can also download and edit the  program  change
  36.      table.   You can then inspect all of the parameter settings for  any
  37.      voice.  (The idea I have is to eventually turn this in to an editor)
  38.  
  39.      The  program  also  allows you to upload any of  the  aforementioned
  40.      automatically.
  41.  
  42.      BEWARE!!   -  when you do an automatic bulk dump the memory type  is
  43.      ignored.   Although  this  means that you can  easily  dump  voices,
  44.      banks,or  complete  memories  from either the internal  or  the  two
  45.      preset memories, when you upload, the voice(s) will always be stored
  46.      in INTERNAL memory at the corresponding voice position.  Thus Preset
  47.      1  bank  A voice 1 when uploaded would be stored in Internal  memory
  48.      bank A voice 1.  NOT IN THE EDITOR BUFFER!
  49.  
  50.      BASIC OPERATING INSTRUCTIONS.
  51.  
  52.      On  the top line of the display there is a ring menu which shows all
  53.      of  the available options.  Either use the cursor keys to  highlight
  54.      the option you require and then press enter, or alternatively double
  55.      click the mouse on any of the options in the ring menu.  The program
  56.      automatically  looks  for  a directory on the current  drive  called
  57.      \voice and will create it if it does not exist.  You are not obliged
  58.      to use this directory but it is the default.
  59.  
  60.  
  61.  
  62.  
  63.  
  64.  
  65.  
  66.  
  67.  
  68.      "Chg_Dir"
  69.  
  70.      This  permits  you  to change from the default directory  \voice  to
  71.      another directory of your choice.
  72.  
  73.      "Select"
  74.  
  75.      Before  displaying a voice file or a program change table file it is
  76.      first necessary to select the required file.  The Select option will
  77.      list  all files contained in the current directory whether they  are
  78.      legitimate  midi files or not.  Either use the arrow keys and  enter
  79.      to  select  the required file or alternatively double click  on  the
  80.      name  of  the file you wish to work with. If there are more than  80
  81.      files  in your directory you can use the 5 key on the numeric pad to
  82.      advance  you  to the next screen or double click the double  chevron
  83.      character  displayed in the bottom right hand corner of the  screen.
  84.      If the file is a valid voice file a window will open which shows the
  85.      basic  characteristics of the voice. If the file is a program change
  86.      table file, a message to that effect will appear in the window.  Any
  87.      other  file  will produce a message to the effect that the  selected
  88.      file contains no midi data.
  89.  
  90.      "Display"
  91.  
  92.      This  function  will display the selected file.  The usage  of  this
  93.      option  is  pretty straightforward.  You may either use the function
  94.      keys  or double the click the button character next to the  function
  95.      key display.
  96.  
  97.  
  98.      "Get_Bulk"
  99.  
  100.      This  option  permits  the automatic downloading of  data  from  the
  101.      synth.   You  may  download a single voice, a bank of 16  voices,  a
  102.      complete memory of 64 voices, or the program change table.  You will
  103.      be  prompted  for the location of the data to download  i.e.   voice
  104.      number,  bank,  or  memory and be asked to supply a  file  name  for
  105.      storage.  If the file already exists you will be asked if it is o.k.
  106.      to  overwrite  it.  The program simply sends a bulk data request  to
  107.      the synth formatted according to the responses entered earlier. When
  108.      data  is  being downloaded, a running count of the number  of  bytes
  109.      being  transferred  will  be displayed.  When  the  download  window
  110.      opens,  if no data appears to be transferring initiate a manual bulk
  111.      dump  from  the synth.  I mention this because I had  some  problems
  112.      trying  to  get  the  timing right and whilst  the  program  behaves
  113.      properly  on my system it is not impossible that problems may  arise
  114.      on a slower (or faster) machine.
  115.  
  116.      "Put_Bulk"
  117.  
  118.      Before  using  this  option, make sure that the bulk  data  transfer
  119.      protect switch is off.
  120.  
  121.      This  option will upload a selected voice, bank, memory, or  program
  122.      change  table file to the synth.  Remember that the INTERNAL  memory
  123.      in your synth will always be overwritten.
  124.  
  125.  
  126.  
  127.  
  128.  
  129.  
  130.  
  131.  
  132.  
  133.  
  134.  
  135.      "SplitBnk"
  136.  
  137.      This  option  takes a previously downloaded bank or memory file  and
  138.      breaks it down into individual voice files.  The files are given dos
  139.      style  names which means some apparent changes to the voice name  as
  140.      illegal  dos file name characters can be used on the synth.  However
  141.      the internal voice name in the downloaded file remains intact.
  142.  
  143.      Things  like  spaces  or  asterisks are  generally  replaced  by  an
  144.      underscore or something legal.
  145.  
  146.      The Program Change Table
  147.  
  148.      It  is  possible  to  download  the  program  change  table  and  to
  149.      subsequently  edit it and re upload.  Because there is no way that I
  150.      know  of to get a hold of the voice names using midi sysex  requests
  151.      the  following  procedure should be adopted to enable you to  get  a
  152.      voice  list  of  each  of the preset banks and  the  internal  bank.
  153.      Download  all three banks using the Get_Bulk command.  Then use  the
  154.      SplitBnk  option  to  break the banks down into  individual  voices.
  155.      While  this  is being done, a file will be written which contains  a
  156.      list  of  all  the voices in the bank.  This file will be  named  as
  157.      follows:-
  158.  
  159.      Preset   Bank 1 will be called preset1.
  160.      Preset   Bank 2 will be called preset2.
  161.      Internal Bank   will be called internal.
  162.  
  163.      A  file is also supplied with this program called "card".  As it  is
  164.      not  possible  to download card based voices, this file  contains  a
  165.      list  of names in the form "card 1" to "card 64".  NB!  All 4 files,
  166.      preset1, preset2, internal, and card must be present in order to run
  167.      the edit option.
  168.  
  169.      To  edit the program change table, first download the program change
  170.      table.   Then Select that file.  Display it using the Display option
  171.      and then select the edit option.  The table is displayed in banks of
  172.      16.   Whilst in edit mode double click either the mode or the  voice
  173.      name  you  wish  to  change.  A window will  open  up  which  either
  174.      displays  the available modes or the list of voice names appropriate
  175.      to  the  memory  location  specified  in  the  mode  selected.   The
  176.      exception to this is card based voices which will be listed as card1
  177.      through  card64.   Simply double click your selection from the  list
  178.      displayed.   (You can double click anywhere within the name  field).
  179.      When  you  are  satisfied with the block you are editing  close  the
  180.      window  by double clicking the button contained in the window border
  181.      and  you will be returned to the previous menu where you may  select
  182.      another  block  of 16.  When you finally exit from this  screen  you
  183.      will  be  prompted  for a file name in which to store  the  modified
  184.      program change table.  You may either overwrite the existing file or
  185.      create  another  one.  This file may then be uploaded to  the  synth
  186.      using  the Put_Bulk option.  When you upload this file to the  synth
  187.      you will probably (make that definitely!) get a midi checksum error.
  188.      This  has no adverse effect and may be ignored.  (If anyone can tell
  189.      me  exactly  how  yamaha calculate their checksums I would  be  very
  190.      grateful!).
  191.  
  192.  
  193.      The  other  functions are self explanatory.  Options called  proc???
  194.      are currently spare and do nothing.
  195.  
  196.  
  197.  
  198.  
  199.  
  200.      The ESC key will always take you back up a level (and ultimately out
  201.      of the program)
  202.  
  203.  
  204.      If you are using a rodent double clicks are always required.  On the
  205.      ring menu double click anywhere in the option you want.  In the file
  206.      select  screen double click anywhere in the required file name.   In
  207.      general  double  clicking the square box contained in the [  ]  will
  208.      exit  that  screen or if associated with a lower level  screen  will
  209.      take you there.
  210.  
  211.  
  212.  
  213.      This  version of the program is freeware.  Do whatever you like with
  214.      it.
  215.  
  216.  
  217.      FEEDBACK WELCOMED (even negative ;-))
  218.  
  219.  
  220.      Mark Smyth (nomad@cix) (100042,1054 on Compuserve)
  221.